home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 05.zip / BS1 part 5 / ScalaMM1.adf / Utilities / Utils.lha / FixScript.doc < prev    next >
Text File  |  1992-06-28  |  4KB  |  98 lines
  1. =============
  2. | FixScript |
  3. =============
  4.  
  5. Description
  6. -----------
  7.  
  8.     FixScript  is  a  small  utility  that  tries  to repair Scala
  9. scripts   that  are  broken  due  to  missing  or  non-existing  files
  10. (pictures,  animations,  sound-files,  fonts etc.).  Imagine copying a
  11. Scala  script  from a friend.  Although the script worked fine at your
  12. friends  home,  there  is a great possibility that the script contains
  13. references  to files that do not exist on your hard-disk or are simply
  14. situated another place, like on another device/partition or in another
  15. directory.   Scala will naturally complain about these errors and will
  16. probably not be able to run the script correctly.
  17.  
  18. Is there a solution?
  19. --------------------
  20.  
  21.     FixScript  solves this problem by checking the complete script
  22. for illegal file references.  If a file is missing, FixScript tries to
  23. locate  the  file  somewhere  else  on the available partitions.  This
  24. search  is  normally  successful.  FixScript corrects all illegal file
  25. references  and  generates  a  new working script that Scala should be
  26. able  to run without problems.  If you need more detailed information,
  27. please see below.
  28.  
  29. Starting up
  30. -----------
  31.  
  32.     Run  FixScript by first Shift-selecting the script you want to
  33. correct  from  WorkBench.   Then,  double-click on the FixScript icon.
  34. FixScript  can  also  be  run from CLI by entering the script path and
  35. filename  as  the first argument.  If you do not feed FixScript with a
  36. script  filename,  it will ask for it...  FixScript will automatically
  37. check  the  script for errors, no other user input is necessary.  Just
  38. click and go!
  39.  
  40. Oooops - Wrong Script!
  41. ----------------------
  42.  
  43.     FixScript  normally  does no harm to a script, even if you try
  44. to  run it on a working script.  However, if you accidentally have run
  45. FixScript on the wrong script, you may hold the keys "Ctrl" + "C" down
  46. for  a  few seconds if you want to abort the program.  Nothing will be
  47. changed in the original script.
  48.  
  49. How FixScript works - Technical information
  50. -------------------------------------------
  51.  
  52.     If  a  file is missing, FixScript will first check if the file
  53. exists  on another partition/device with the same directory name.  All
  54. valid volumes will be examined.
  55.  
  56.     If  the file could not be located on another partition/device,
  57. FixScript  has  no other choice but doing a deep-scan of the harddisk,
  58. looking for that specific file.  Since this normally takes quite a lot
  59. of  time,  FixScript allows you to specify the path to directories (or
  60. volumes)  that  should  be  scanned first via "Tool Types" (Please see
  61. below for more informatin about how to enter ToolType info).
  62.  
  63.     It  the  file  still  could  not  be  located  in any of these
  64. directories  (or if no "Tool Type" info was available), FixScript will
  65. automatically  scan  all  volumes.  This will take some time so please
  66. have    patience    (Note:    FixScript   automatically   places   all
  67. directory-listings in memory so that multiple seeks take approximately
  68. the same time as single ones).
  69.  
  70. A note on non-existing files
  71. ----------------------------
  72.  
  73.     If  a missing file could not be located anywhere on any of the
  74. available  volumes,  FixScript  will remove the related command/action
  75. from  the  script.   Missing  fonts will be replaced with another font
  76. that  has  equal  or almost equal size.  Non-existing pictures will be
  77. replaced  with  a  blank  picture.   Later on, you may want to replace
  78. these  blanks with real pictures.  As you've probably guessed, this is
  79. easily done by using Scala to modify the script.
  80.  
  81. How to enter ToolType information
  82. ---------------------------------
  83.  
  84.     ToolType  information  can  be  entered  by  clicking  on  the
  85. FixScript   icon  and  selecting  "Info"  or  "Information"  from  the
  86. WorkBench  menu.   The  ToolType  line  that starts with "DIR=" should
  87. contain  a list of directories that should be checked first.  Multiple
  88. directory-names  should  be seperated with a '|'.  FixScript reads the
  89. names  from left to right.  This means that the directory-name closest
  90. to  the  left  edge of the window has the highest priority and will be
  91. checked first.
  92.  
  93.     If FixScript should first check the directory Work:Scala, then
  94. Work:Pictures   and   finally   Leisure:Animations,  this  line  would
  95. typically read:
  96.  
  97. DIR=Work:Scala|Work:Pictures|Leisure:Animations
  98.